🚀 Why - 해결하려는 문제가 무엇인가요?

• Swagger에서 토큰 입력이 실제 요청 헤더에 적용되지 않아, 인증이 필요한 API 호출이 401로 실패하는 문제가 있었습니다.
• 로그인 직후 발급된 토큰도 블랙리스트로 오판되어 인증이 막히는 현상이 있어, 원인을 추적하고 개선이 필요했습니다.

✅ What - 무엇이 변경됐나요?

• ApiDoc별 bearerAuth 적용/해제 정리
  • 보안 스키마 이름을 bearerAuth로 통일
  • 필요한 ApiDoc에만 @SecurityRequirement(name = "bearerAuth") 적용
  • 공개 API는 Swagger에서 보안 표시가 붙지 않도록 security = {} 명시
• 전역 Swagger security 제거
  • 전역 @OpenAPIDefinition.security 제거하여 불필요한 자물쇠 표시/강제 보안 적용 제거
• Redis 토큰 조회 null 처리로 인증 블랙리스트 오판 방지
  • Redis에서 키가 없을 때 "" 반환 → null 반환으로 수정하여 정상 토큰이 블랙리스트로 판정되는 문제 해결

🛠️ How - 어떻게 해결했나요?

• Swagger 인증 문제 해결

  • Swagger 보안 스키마 이름을 bearerAuth로 통일하고,
  • 실제 토큰이 헤더에 붙도록 필요한 ApiDoc에만 @SecurityRequirement(name = "bearerAuth")를 명시했습니다.
  • 전역 @OpenAPIDefinition.security를 제거해, 모든 API에 보안이 강제 적용되는 문제를 줄였습니다.
  • 공개 API(/v1/experts, /v1/experts/{expertId})는 Swagger에서 보안 표시가 붙지 않도록 security = {}로 명시했습니다.

• 블랙리스트 오판(로그아웃 토큰 체크) 해결

  • Redis 조회 로직에서 키가 없을 때 ""를 반환하던 동작 때문에,
    블랙리스트 체크가 항상 true로 평가될 수 있어 null 반환으로 수정했습니다.

• 고민/예외 사항

  • Swagger “자물쇠 표시”는 전역 설정/ApiDoc 설정이 섞이면 혼란이 커져, 전역 제거 + 필요한 곳만 명시 방식으로 정리했습니다.
  • 토큰 블랙리스트 체크는 “키 없음”과 “값 존재”를 명확히 구분하도록 반환값 정책을 통일했습니다.

💬 기타 코멘트

• 디버그 로그로 확인한 결과, Swagger에서 Authorization 헤더 자체가 붙지 않는 상태였고,
  @SecurityRequirement의 name 불일치가 원인이었습니다.
• Redis가 빈 문자열을 반환하면서 블랙리스트 판정이 항상 true가 되어 정상 토큰도 차단되는 현상이 있었습니다.
• 테스트 방법
  • Swagger UI에서 토큰 입력 후 인증 API 호출 성공 확인
  • curl로 /v1/members 호출하여 인증 성공 확인

Summary by CodeRabbit

릴리스 노트

• 새로운 기능

  • API 문서에서 인증이 필요한 엔드포인트 명시

• 버그 수정

  • 인증 토큰 검증 로직 개선 및 명확화

• 개선 사항

  • 보안 인증 표준화 (Bearer 인증 스킴 통일)
  • API 보안 설정 최적화

_{✏️ Tip: You can customize this high-level summary in your review settings.}